---
title: "Basic"
description: "Create a basic AI agent with ChatGPT-like web interface"
---

## Code

```python cookbook/os/interfaces/agui/basic.py
from agno.agent.agent import Agent
from agno.models.openai import OpenAIChat
from agno.os import AgentOS
from agno.os.interfaces.agui import AGUI

chat_agent = Agent(
    name="Assistant",
    model=OpenAIChat(id="gpt-5-mini"),
    instructions="You are a helpful AI assistant.",
    add_datetime_to_context=True,
    markdown=True,
)

agent_os = AgentOS(
    agents=[chat_agent],
    interfaces=[AGUI(agent=chat_agent)],
)
app = agent_os.get_app()

if __name__ == "__main__":
    agent_os.serve(app="basic:app", reload=True)
```

## Usage

<Steps>
  <Snippet file="create-venv-step.mdx" />

  <Step title="Set Environment Variables">
    ```bash
    export OPENAI_API_KEY=your_openai_api_key
    ```
  </Step>

  <Step title="Install libraries">
    ```bash
    pip install -U agno ag-ui-protocol
    ```
  </Step>

  <Step title="Run Example">
    <CodeGroup>
    ```bash Mac
    python cookbook/os/interfaces/agui/basic.py
    ```

    ```bash Windows
    python cookbook/os/interfaces/agui/basic.py
    ```
    </CodeGroup>
  </Step>
</Steps>

## Key Features

- **Web Interface**: ChatGPT-like conversation experience
- **Real-time Chat**: Instant message exchange
- **Markdown Support**: Rich text formatting in responses  
- **DateTime Context**: Time-aware responses
- **Open Protocol**: Compatible with AG-UI frontends

## Setup Frontend

1. Clone AG-UI repository: `git clone https://github.com/ag-ui-protocol/ag-ui.git`
2. Install dependencies: `cd ag-ui/typescript-sdk && pnpm install`
3. Build integration: `cd integrations/agno && pnpm run build`
4. Start Dojo: `cd ../../apps/dojo && pnpm run dev`
5. Access at http://localhost:3000

